home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / unclutter.1 < prev    next >
Text File  |  1995-07-25  |  5KB  |  133 lines
  1.  
  2.  
  3.  
  4.      UUUUNNNNCCCCLLLLUUUUTTTTTTTTEEEERRRR((((1111XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             UUUUNNNNCCCCLLLLUUUUTTTTTTTTEEEERRRR((((1111XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           unclutter - remove idle cursor image from screen
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           uuuunnnncccclllluuuutttttttteeeerrrr [----ddddiiiissssppppllllaaaayyyy|----dddd _d_i_s_p_l_a_y] [----iiiiddddlllleeee _s_e_c_o_n_d_s] [----jjjjiiiitttttttteeeerrrr
  13.           _p_i_x_e_l_s] [----ggggrrrraaaabbbb] [----nnnnooooeeeevvvveeeennnnttttssss] [----rrrreeeesssseeeetttt] [----rrrrooooooootttt] [----oooonnnneeeessssccccrrrreeeeeeeennnn]
  14.           [----nnnnooootttt] _n_a_m_e ...
  15.  
  16.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  17.           uuuunnnncccclllluuuutttttttteeeerrrr removes the cursor image from the screen so that
  18.           it does not obstruct the area you are looking at after it
  19.           has not moved for a given time.  It does not do this if the
  20.           cursor is in the root window or a button is down.  It tries
  21.           to ignore jitter (small movements due to noise) if you have
  22.           a mouse that twitches.
  23.  
  24.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  25.           -display
  26.                is followed by the display to open.
  27.  
  28.           -idle
  29.                is followed by the number of seconds between polls for
  30.                idleness.  The default is 5.
  31.  
  32.           -jitter
  33.                is followed by the amount of movement of the pointer
  34.                that is to be ignored and considered as random noise.
  35.                The default is 0.
  36.  
  37.           -grab
  38.                means use the original method of grabbing the pointer
  39.                in order to remove the cursor. This often doesn't
  40.                interoperate too well with some window managers.
  41.  
  42.           -noevents
  43.                stops unclutter sending a pseudo EnterNotify event to
  44.                the X client whose cursor has been stolen.  Sending the
  45.                event helps programs like emacs think that they have
  46.                not lost the pointer focus.  This option is provided
  47.                for backwards compatibility in case some clients get
  48.                upset.
  49.  
  50.           -reset
  51.                resets the timeout for idleness after the cursor is
  52.                restored for some reason (such as a window being pushed
  53.                or popped) even though the x y coordinates of the
  54.                cursor have not changed.  Normally, the cursor would
  55.                immediately be removed again.
  56.  
  57.           -root
  58.                means remove the cursor even if it is on the root
  59.                background, where in principle it should not be
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/25/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      UUUUNNNNCCCCLLLLUUUUTTTTTTTTEEEERRRR((((1111XXXX))))             UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             UUUUNNNNCCCCLLLLUUUUTTTTTTTTEEEERRRR((((1111XXXX))))
  71.  
  72.  
  73.  
  74.                obscuring anything useful.
  75.  
  76.           -onescreen
  77.                restricts unclutter to the single screen specified as
  78.                display, or the default screen for the display.
  79.                Normally, unclutter will unclutter all the screens on a
  80.                display.
  81.  
  82.           -not is followed by a list of window names where the cursor
  83.                should not be removed.  The first few characters of the
  84.                WM_NAME property on the window need to match one the
  85.                listed names.  This argument must be the last on the
  86.                command line.
  87.  
  88.      LLLLIIIIMMMMIIIITTTTAAAATTTTIIIIOOOONNNNSSSS
  89.           Unfortunately, clients like emacs set different text cursor
  90.           shapes depending on whether they have pointer focus or not,
  91.           and so not only does the cursor pixture go, but the text
  92.           cursor image changes.  Even more sadly, some window managers
  93.           like to remove keyboard focus if pointer focus is lost.
  94.  
  95.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  96.           The message
  97.  
  98.            someone created a sub-window to my sub-window!
  99.  
  100.           means that unclutter thinks a second unclutter is running,
  101.           and tried to steal the cursor by creating a sub-window to
  102.           the sub-window already used to steal the cursor.  This
  103.           situation quickly deteriorates into a fight no one can win,
  104.           so it is detected when possible and the program gives up.
  105.  
  106.      AAAAUUUUTTTTHHHHOOOORRRR
  107.           Mark M Martin. cetia 18dec1992. mmm@cetia.fr
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/25/95)
  130.  
  131.  
  132.  
  133.